VERITAS - USER MANUAL
====================

Project Name:
Veritas

--------------------------------------------------
1. OVERVIEW
--------------------------------------------------

Veritas is a browser extension that analyzes online news articles and provides
a political leaning assessment based on three signals:

- Source Bias
- Language Bias
- Framing Bias

It also provides a confidence score and a summary explaining the result.

--------------------------------------------------
2. SYSTEM REQUIREMENTS
--------------------------------------------------

To use Veritas, the following are required:

- Google Chrome browser
- Python 3.9 or higher
- Internet connection
- Valid API key configured in the backend

--------------------------------------------------
3. INSTALLATION SUMMARY
--------------------------------------------------

(Full details are provided in the Installation Guide)

1. Install Python dependencies
2. Configure the .env file with API key
3. Run the FastAPI backend server
4. Load the Chrome extension using "Load unpacked"
5. Open any news article

--------------------------------------------------
4. HOW TO USE VERITAS
--------------------------------------------------

Step 1: Open a News Article
- Navigate to any online article in Chrome.

Step 2: Open the Extension
- Click the Veritas icon in the Chrome toolbar.
- The popup window will appear.

Step 3: Start Analysis
- Click the "Analyze Page" button.
- The system will:
  1. Extract visible text from the article
  2. Send the data to the backend
  3. Perform analysis using AI

Step 4: View Results
- The UI will update with:

  Article Overview:
  - Source (website domain)
  - Publication date
  - Number of claims detected

  Bias Signals:
  - Source Bias (range: -1.0 to 1.0)
  - Language Bias (range: -1.0 to 1.0)
  - Framing Bias (range: -1.0 to 1.0)

  Leaning Verdict:
  - One of the following:
    Left-leaning
    Center-left
    Center
    Center-right
    Right-leaning
    Unclear

  Summary:
  - A short explanation of why the article received that classification

  Confidence:
  - A value between 0.0 and 1.0 indicating certainty of the result

--------------------------------------------------
5. SETTINGS
--------------------------------------------------

Click the "Settings" button in the extension footer.

Available options may include:
- Toggle dark mode
- Show or hide article overview
- Show or hide extracted claims
- Enable or disable debug information

Settings are saved locally in the browser.

--------------------------------------------------
6. STATUS INDICATORS
--------------------------------------------------

The status pill at the top shows system state:

- Idle: No analysis has been run
- Analyzing: Processing article
- Done: Analysis completed successfully
- Error: Something went wrong
- No text: No readable content found

--------------------------------------------------
7. LIMITATIONS
--------------------------------------------------

- The system does NOT verify factual truth
- Results are estimates based on patterns and language
- Some articles may not contain enough text for analysis
- Paywalled or dynamically loaded content may not be extracted correctly
- Bias scores are heuristic-based, not absolute measurements

--------------------------------------------------
8. TROUBLESHOOTING
--------------------------------------------------

Issue: "Error" status
Solution:
- Ensure backend server is running
- Check API key in .env file
- Verify internet connection

Issue: No results appear
Solution:
- Ensure the page contains readable article text
- Try refreshing the page

Issue: Extension does not load
Solution:
- Reload extension in Chrome
- Check for manifest errors

--------------------------------------------------
9. BEST USE PRACTICES
--------------------------------------------------

- Use Veritas as a support tool, not a final authority
- Compare results across multiple articles
- Be aware of potential bias in all sources
- Use the summary to understand reasoning

--------------------------------------------------
10. CONTACT / SUPPORT
--------------------------------------------------

For issues or questions, refer to project documentation or contact the developer team.

End of User Manual